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1. Building Ground Servers 



In this manual we will demonstrate how the BeLL Ground Server design can be used to set up a 
Sneakernet using the principles of Ground Computing. Future tutorials will include how to 
manage the Ground Server Lite and Ground Server Mobile designs. We'll start by getting the 
hardware together and prepare SD cards using an Internet connection. Later parts of this tutorial 
will not require an Internet connection, only the first download of the required software will require 
an Internet connection. 

Putting the hardware together 




The BeLL Ground Server is a 17 Watt Ground Server that supports up to 30 WiFi devices, 
includes data redundancy, and supports replication with travelling SD Cards and/or the BeLL 
Ground Server Mobile design. These things are the backbone of the Sneakernet. 



- 2 Raspberry Pis ($35x2, a second Pi for data redundancy and the ability to send an SD Card to 
the next node for replication) 

- 2 Raspberry Pi cases ( $7.35x2 ) 

- 1 WiFi Router (Suggested TP-Link TL-WDR3500 at $50) 

- 1 Micro USB Charger ($6) 

- 1 short Micro USB-male to USB-male chord ( $1.49 ) 

- 2 short RJ-45 Ethernet cables ( $.49x2 ) 

- 3 SD Cards ( $9x3 , the third card is for when the second card is traveling to another node for 
replication) 

Total: $170 

Setting up SD cards 

Now that you have your hardware together, you'll want software to run on your Pi's. In the next 
few steps we walk through installing various things you'll want on your Pi's SD Cards, but if you 
want to skip this, download the finished product (link coming) and move on to "Cloning SD 
Cards". 

Download Occidentalis and follow the instructions here . 

Now that you have your Occidentalis image on your SD card, boot up your Raspberry Pi for the 
first time with the Occidentalis image installed. If you don't have a keyboard and monitor for the 
Pi, you can ssh into the from a Mac or Linux PC by running "ssh pi@raspberrypi. local" with a 
password of "raspberry". First, run "raspi-config" and select expand_rootfs to expand the 
memory card to the limits of your SD Card otherwise you will have very little free memory. Then 
navigate to "Finish" (down down down right) and your Pi will restart to do the resize operation 
(this takes a few minutes). When you log in again you'll want to run the following command to 
get the wonderful scripts written by Adafruit described in Deploying Ground Servers. 

curl https://raw.github.com/adafruit/Adafruit-WebIDE/alpha/scripts/install.sh | sudo sh 

Also run the date command to make sure your Pi has the correct date settings (important later 
for resolving merge conflicts in data replication). 



Installing CouchDB 

CouchDB is a a fully decentralized and Open Source data platform that also has the ability to 
serve Ground Apps! CouchDB's replication feature is the glue that holds the network together 
making possible Eventual Consistency in the network, a core concept in Ground Computing . 



Check out the groovy tutorial on installing CouchDB from the BeLL Development Bloq. 

Getting started with Ground Apps 

Now that you have CouchDB installed on your Raspberry Pi, it's time to get some Ground Apps 
for your users to use! If you are interested in the code of the following apps mentioned, check it 
out on the Open Learning Exchange organization page on GitHub . Don't forget to fork us! :) 



Apache CouchDB - Futon: Overview 
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You can access your Pi from an mDNS compatible device at http://raspberrypi.local , CouchDB 
is on port 5984 by default, and we want to go to the default Futon CouchApp at 
http://raspberrypi.local:5984/ utils . Create your first user (I've created user "hammock") and 
create a database to place some Couch Apps into. 
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Couch Replicator 
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Lets get some CouchApps from http://bell.iriscouch.com . There are a couple of different ways to 
get CouchApps for CouchDB installed. Max Ogden's extension for Google Chrome makes it 
pretty easy. 
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But since you might not have that Chrome extension handy, you can also replicate the library 
database on bell.iriscouch.com to get all of the CouchApps there. 
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Username: 
Password: 



Login 



At http://raspberrypi.local:5984/library/ desiqn/library/app.html you'll find the BeLL School Library 
App. 
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MoziJIa Firefox 
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Now you can browse some Open Educational Resources by subject and level. 
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Mozilla Firefox 
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Clicking "begin" on a resource will open it up into in the appropriate HTML5 App. Clicking 
"download" will download the resource to your local machine. Clicking "feedback" will show you 
feedback on the resource and allow you add your own feedback. 
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When you add resources, make sure to select the correct HTML5 App for the kind of document 
you are uploading so the "begin" button will work correctly. 



Cloning SD Cards 

Now that you have your first SD card all ready for Ground Computing, you'll want to clone it to the 
other 2 SD Cards for the BeLL Ground Server you are creating. The first thing you're going to do 
is create an "image" (.img) file of what you just cooked up. Before you plug the SD Card into an 
SD Card Reader and plug that into a Mac or Linux PC, run the "df" command from a terminal on 
your PC. Observe the drives listed. You'll now plug your SD Card reader into your PC and run 
"df again to see what new drive is available. Now unmount that new drive by using the "umount" 
command. On Macs you may need to use the "diskutil umount" command. 

> sudo umount /dev/disk1s2 

Now for converting the disk to an image. Note that this command will take a while and the 
resulting img file will be as large as the SD Card's total memory. 

> dd if=/dev/disk1 of=./newDisklmage.img 

Now replace that SD Card with a blank SD Card. Run the df command to find it, and then 
unmount it with umount. At last we're ready to put that img onto a new SD Card. Run: 

> dd if=./newDisklmage.img of=/dev/disk1 

When that finishes, plug in your third SD Card, umount it, and then dd the image onto it. 

2. Deploying Ground Servers 

Configuring Ground Servers on LAN 

By default, Occidentalis will boot with Avahi Daemon running with hostname raspberrypi.local . 
Avahi Daemon is a service that broadcasts a hostname with the Pi's IP address so that other 
devices on the network can address the device reliably by hostname as opposed to clients 
having address a network service device by IP address which is prone to change and difficult to 
manage ( Read more about Zero Configuration Networking 

http://en.wikipedia.org/wiki/Zero_configuration_networking ). Host names are also a lot easier to 
remember than an IP address so we're going to give your new Ground Servers memorable 
hostnames. Note, changing the hostname from the default hostname of raspberrypi.local leaves 
the raspberrypi.local hostname open for new devices to be configured on the network. Win! 



Optional settings for your PI. 

If you're sharing multiple Pis on the same network, you can change the hostname of your Pi here. You can also configure the 
Wifl settings. Both of thssa features are optional, and may db skipped. 

If you iBave these fields blank, they will not overwrite your existing settings. 

You can update these settings at any time in the future. 

Change your Pi Hostname (optional! 




Choose a different Port (optional, default Is BO, manual server restart required} 



Configure your WIFI settings (optional) 



WIFI Password: 



From an mDNS compatible device you'll want to go to raspberrypi.local/config 
Enter a new hostname for this Pi so other Pi's can be introduced onto this network and 
configured from http://raspberrvpi.local/confiq , otherwise you'll have multiple Pi's fighting over the 
raspberrypi hostname. 




Optional settings for you' Pi 

If you re sharing multiple Pi's on the same network, you can change the hostname of your Pi here. You can also configure the 
Wifl settings. Both of these features are optional, and may be skipped. 

If you leave these fields blank, they will not overwrite your existing settings. 

You can update these settings at any time in the future. 

ChangB yonrjj Hostname (optional)_ 

Hostname: 

Choose a different Port [optional, default is 80, manual server restart required) 



Configure your WIFI settings (optional) 




WiFi Password: 




Enter a hostname of "bell" and then click Submit Query. If you get an error of "Server Not Found", 



don't worry, the mDNS takes a minute sometimes to propagate so in a few minutes try 
http://bell.local/ again. If after a few minutes it still doesn't work, try again at 
http://raspberrypi.local/config 
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Welcome to the Raspberry Pi WeblDE powered by the Adafruit Learning System 

Setting up your Raspberry Pi will only take a tew minutes. Let's get started. 

Are you setting up more than ore Raspberry Pi? Visit the config to change hostname and WiFi. 

One of the many useful features of the WeblDE is that allot your code will be stored in the cloud over at bitbucket.org. So h 

before we can go any further, you will want to create your free Bitbucket account. If you already have one, you can use your 

existing account, or create one specifically for the Raspberry Pi WeblDE. 



;iick here to create your free bitbucket account 
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In youf Account page, click on the Integrated Applications link in the left column; 



Ta da! Your first Pi is now at http://bell.local/ 
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Mozilla Firefox 
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And here is CouchDB on port 5984 and the BeLL Library App at 
http://bell.local:5984/library/ design/library/app.html 



3. Setting up the Sync Server 

Now you'll want to set up your Sync Server using your second Pi so your can sync with other 
nodes in the Sneakernet. Plug one of your SD Cards that still has hostname of "raspberrypi" into 
your second Pi and plug it into the network. Repeat the process above for changing the 
hostname except this time you'll want to rename the hostname to "sync". 
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Are you setting up more than oris Raspberry Pi? Visit the eonfig to change hestnamt 

One of the many useful features of the WeblDE is that all of your code will be stored in thB cloud o 

before we can go any further, you will want to create your free Bitbucket account. If you already ha 

existing account, or create one specifically for the Raspberry Pi WeblDE. 



Click here to create your free bitbucket account 
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Repositories 



The end result will be a Pi accessible at http://bell. local/ and a Pi accessible at http://sync.local/ 
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Apache CouchDB - Futon: Overview 
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Futon on Apachfl CuuchDH 1.2.0 



Go to the Futon CouchApp on each Grond Server at http://bell.local:5984/ utils and 

http://svnc.local:5984/ utils 
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Apache CouchDB - Futon: View Document 
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Click on "New Document" and then "Add Field" until the fields look like the screenshot. Note that 



this object editing interface can be a little confusing to use. Double click to edit things and then 
press the enter key to confirm them. For _id, We have chosen a replicator entry naming 
convention of {database}-{source}-{target}. The source field is where we'll be looking for new 
data while the target field is where we will be placing new data. The continuous field is what will 
tell CouchDB to continue, even after we first submit this, to look for changes in the source 
database to replicate to the target database. Because the target is local and the source is 
remote, this is referred to as pull replication. Now we're going to set up push replication from 
sync. local to bell. local. 
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Apache CouchDB - Futon: View Document 
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Create another document in the _replicator database and set it up as shown above. Note the 
source and target have been reversed from the pull replication example. This is because we 
want changes on the sync. local server to be pushed to the database on the bell. local server, this 
is push replication. 

Push replication + Pull replication = Sync! 



Let's do a quick test to see if creating a document in one database will cause it show in the other 
database. 
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Test resource on BeLL Server 




Title | Test resource on Sync Server 

Author | R.J. Steinert 

Description f "| 



At http://bell.local:5984/library/ desiqn/library/app.html#paqe-resource-form and 
http://sync.local:5984/library/ desiqn/library/app.html#paqe-resource-form I add two files, one on 
each server. 
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Test resource on BeLL Server 



+ Test resource on Sync Server 




There they both are on both servers! The sync is working. 



4. Sync your BeLL Ground 
Server with other nodes in the 
Sneakernet 



If you have an Internet connection, check out my demonstration video: 
http://www.youtube.com/watch?v=aQWXaOVAJcQ 
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SD Card with hostname of sync 
(http://sync.local/) 



SD Card with hostname of sync 
(http://sync. local/) 



To sync one BeLL Ground Server to another BeLL Ground Server, all you need to do is move the 
SD Card with hostname sync from one Node's Pi to the place where the other Node's sync SD 
Card usually sits. 



The BeLL Ground Server is designed to facilitate many to many data replication. 




In one to many data replication, all data moves through a parent node before it can move to the 
children nodes. 




For data to move from node A to node C in a one to many data network, data has to replicate to 
node B before it can move to node C. 




For data to move from node A to node C in a many to many data network, data can travel directly 
between node A and C or even hop between neighboring nodes. 




In a many to many data network, data can move in any direction and hop from node to node is 
the most efficient path or even the most inefficient. 



